home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1996 July / Macworld (1996-07).dmg / Shareware World / Communication / WarpSearch CGI 1.0 / About WarpSearch.txt next >
Text File  |  1996-05-24  |  4KB  |  59 lines

  1. What is WarpSearch?
  2. ------------------
  3. WarpSearch is a *fast* non-indexed TEXT and HTML search utility that functions in both local and CGI mode.  It works with any CGI-compatible Macintosh web-server, including NetPresenz, MacHTTP, WebSTAR, and many others.  Speed tests on an old Mac IIci measure WarpSearch at over 500kb/sec and the newer PowerPC Macs perform far better.
  4.  
  5. Unlike other applications of its type, WarpSearch will perform blazingly fast searches on text files of any size without adjusting its RAM requirements!  WarpSearch consumes a mere 400k of RAM.  Included in the archive is the Webster's Bible (4.4Mb uncompressed) as individual books for your own web-site and speed tests.
  6.  
  7. WarpSearch is $15 shareware, payable by US cash or Money Order to:
  8.  
  9. Glen Stewart (glen_stewart@associate.com)
  10. 1434 Rollins
  11. Grand Blanc, MI 48439
  12.  
  13. Upon receipt of payment, instructions will be sent via e-mail to allow you to register your copy.
  14.  
  15.  
  16. What do I need to run WarpSearch?
  17. --------------------------------
  18. a). Any functioning CGI-capable Macintosh web server
  19. b). Folders full of TEXT and/or HTML files that remote Web-browsers can search
  20.  
  21.  
  22. How do I set WarpSearch up and run it?
  23. -------------------------------------
  24. 1. Place the WarpSearch application wherever your other CGI's are located.  Follow your web-server's documentation for using CGI's.  WarpSearch must be in THE SAME folder as all the searchable folders are located.  So in the case of our included folder, "The_Bible", it would be located in the same folder as WarpSearch.
  25.  
  26. 2. Carefully review and modify the included file, "warpsearch.html" to suit your needs.  WarpSearch *must* see the following line (part of a FORM definition) in the HTML file:
  27.  
  28. <SELECT NAME="searchFolder">
  29.  
  30. ...and that line must be immediately followed by other lines like:
  31.  
  32. <OPTION VALUE="CyberChurch_news">CyberChurch News
  33. <OPTION VALUE="Digests">Mailing List Digests
  34. <OPTION VALUE="ministry_files">Ministry Files
  35. <OPTION VALUE="The_Bible">The Bible
  36.  
  37. The names within the quotes are the folder names containing files you want WarpSearch to look through when local or CGI forms-based search requests are made.  These names must *exactly* match the folder names where you store your searchable files.  The names after the ">" are what your remote web-browser user will see when using the HTML form's pull-down menu.  Fire up NetScape by drag & dropping  "warpsearch.html" onto it, and you'll see this menu.  
  38.  
  39. The end of your searchable folder list is reached when WarpSearch sees the line:
  40.  
  41. </SELECT>
  42.  
  43. While WarpSearch starts up, it scans your "warpsearch.html" file and builds the local search menu based on the folders you have defined in your HTML form.  Don't worry - if you mis-spell a folder name, WarpSearch will gracefully avoid using that folder when it performs searches.  You can have anything else you want in your HTML file, as long as the above conditions are met and the search text uses the variable "searchText" as shown in the following line:
  44.  
  45. <INPUT TYPE="text" NAME="searchText" SIZE="25" MAXLENGTH="40">
  46.  
  47. 3. Double-click on the WarpSearch application and note the contents of the "Search..." menu.  These should be the folder names located in the same directory as WarpSearch that contain the files you wish to search.  You may select any of these menu items to try a local search now.  Fast, huh?  Like that Copy and Select All menu item in the Edit menu?  They come in handy!
  48.  
  49. 4. Now run your favorite web-browser and remotely access the "warpsearch.html" form we've discussed so far.  Try a WarpSearch!  Once registered, remote users will no longer see the UNREGISTERED title bar and memo within the form displaying how many days you've been evaluating WarpSearch.
  50.  
  51. 5. For best speed, leave WarpSearch running all the time, though it only takes a couple seconds to start up.
  52.  
  53. 6. Feel free to use the WarpSearch.GIF at  http://associate.com/bbs_mug.html  for your own WarpSearch web page.
  54.  
  55. 7. Registered users will be notified via e-mail when new versions of WarpSearch are released.
  56.  
  57.  
  58. Release Notes:
  59. April 20, 1996: v1.0 - first release of WarpSearch